home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / forth83.arc / F83.DOC < prev   
Encoding:
Text File  |  1984-06-20  |  7.0 KB  |  150 lines
  1. .PO 3
  2.  
  3.     WELCOME TO FORTH  
  4.  
  5.      This   is  a  public  domain  system,  and  may  be   freely 
  6. distributed  and copied, as long as the authors are given  credit 
  7. and  no copyright notice is placed upon it.  If we catch  someone 
  8. selling this system as their own proprietary product, with  their 
  9. copyright notice , we will do our best to make them regret it for 
  10. the rest of their lives.  You have been warned!!
  11.  
  12.      By  now  you may have looked at some of the files  with  the 
  13. cp/m TYPE command.  You can have a printout of these instructions 
  14. by using Control P and entering  TYPE FORTH.DOC
  15.  
  16.      In  what  follows the <CR> symbol  represents  the  carriage 
  17. return  key  on  your terminal.  To enter  Forth  from  the  CP/M 
  18. environment,  insert  the disk containing the F83.COM  file  into 
  19. drive  A of your computer, (after booting it of course) and  type 
  20. F83<CR>
  21.  
  22.      Forth will reply with:
  23.  
  24. 8080 Forth 83 Model 1.0.0
  25. Modified 11Oct83
  26.  
  27.  
  28. Forth is about ten years old now (1983) but some of the  features 
  29. of F83 are relatively new to the Public Domain Forth Model.
  30.   
  31.      The  VIEW command is one of the best. VIEW <word> <CR>  will 
  32. find  the screen that contains the code for the <word>,  provided 
  33. that  the  file that contains <word> is on the  currently  logged 
  34. disk  drive.  If you can fit all of the source code on  a  single 
  35. drive,  VIEW works great, and takes care of opening the file  and 
  36. displaying the screen for you.  
  37.  
  38.      We  have  also  tried to make extensive use  of  the  shadow 
  39. screen  concept.  In this regard, the A word moves you  from  the 
  40. current  screen  to  it associated  shadow  screen.   The  SHADOW 
  41. vocabulary  contains  a  bunch  of  words  that  are  helpful  in 
  42. maintaining  shadow screens.  COPY allows you to copy not only  a 
  43. screen, but also its associated shadow.  SHOW allows you to  list 
  44. each source screen across from its shadow when you want to  print 
  45. them.   Finally CONVEY allows you to move groups of  screens  and 
  46. their  associated shadows.  To see what words are in  the  SHADOW 
  47. vocabulary simply type SHADOW WORDS<CR>
  48.  
  49.      There  is  also  a decompiler  present  which  reverses  the 
  50. compiling  process, producing source code from object code.   The 
  51. user  interface to it is the word SEE <name> where <name> is  the 
  52. name  of  a  Forth  word  you  wish  to  decompile.   While   the 
  53. information  SEE  gives you is not as complete as that  given  by 
  54. VIEW,  a  least it is always available, and  not  dependant  upon 
  55. whether  or  not  the correct file is present  on  the  currently 
  56. logged in disk drive.  For a real experience try decompiling  the 
  57. words STATUS, which is a DEFERred word, ie and execution  vector.  
  58. SEE  calls  itself recursively in this case and tracks  down  the 
  59. definition.  This can be quite handy.
  60.  
  61.      To  see a list of the words that are in the dictionary  type 
  62. WORDS.   You will see lots of words.  Each is a command and  each 
  63. can be VIEWed.  Let's look at the word SHOW by typing VIEW  SHOW.   
  64. Assuming  all is well you will see a Forth screen containing  the 
  65. definition  of SHOW along with some other words. Type  A  L  (cr)  
  66. and  you will be rewarded with the Shadow screen that  goes  with 
  67. it.   A  L  (cr)  will Alternate List you back  to  the  original 
  68. screen of code.  Look at it and when you see a word that  doesn't 
  69. seem fully self evident, VIEW it and read the shadow screen.  The 
  70. word  SHOW and it's source code that we have been viewing,  is  a 
  71. command  that  prints out three source screens along  with  three 
  72. shadows  for  a  total of six screens per page.   There  are  two 
  73. versions of SHOW.  The vocabulary you are in determines how  SHOW 
  74. will print out.  If you are in the SHADOW vocabulary, six screens 
  75. of  code  and shadows will print.  If you are in FORTH  all  code 
  76. screens will be the mode.     
  77.  
  78.      Now  for  some more commands.   N is next screen  and  L  is 
  79. list.  N L  lists the next screen and  B L lists the next  screen 
  80. back.   N ED will edit the next screen etc. Now lets  printout  a 
  81. few  screens that will detail some of the editor  commands.  Most 
  82. are from Starting Forth but some are new ones.  
  83.  
  84. Type this: EDITOR VIEW JOIN<CR>
  85.  
  86. You are looking at a screen of editing commands.  Lets go to  the 
  87. shadow  with the  A L  command and do some exploring.   While  we 
  88. are  in  the  shadows lets look at the next five  or  six  shadow 
  89. screens  that  should be editor words.  Use N L.  If you  have  a 
  90. printer  you may print these screens now as follows.   Type  VIEW 
  91. WIPE  for example.   If wipe is the first of 6 screens of  editor 
  92. words remember the screen number.  If for instance it was 80 then 
  93. type  80 85 SHADOW SHOW<CR> 
  94.  
  95.      If  you  are new to Forth your best bet is to  purchase  the 
  96. book  STARTING  FORTH by LEO BRODIE.  It  costs  about  seventeen 
  97. dollars  and is available at most large book stores.  On page  84 
  98. you  will find the commands for the line editor.  The  F83  model 
  99. follows both the book and the Forth 83 standard.
  100.  
  101.      The  Forth  Interest Group ( FIG ) has meetings on  the  4th 
  102. Saturday  of  each  month, currently at  the  Chabot  College  in 
  103. Hayward,  CA.  Call the FIG hot line if you wish to double  check 
  104. the location ph 962-8653 or the FIG Tree BBS (300 baud)
  105. at 538-3580.
  106.  
  107. Henry Laxen                                  Mike Perry
  108. 1259 Cornell Avenue                          1125 Bancroft Way
  109. Berkeley, CA 94706                           Berkeley, CA 94702
  110.  
  111. .pa
  112.              Standard System Documentation Requirement
  113.  
  114. 1.  The  system  dictionary space is CPU  dependant  and  can  be 
  115. determined by typeing HERE U. <CR>
  116.  
  117. 2. The application dictionary space is also CPU dependant and  is 
  118. the  difference  between  the  top  of  the  dictionary  and  the 
  119. beginning of the parameter stack.  The location of the  parameter 
  120. machine.   The application dictionary space can be determined  by 
  121. typing SP@ HERE - U. <CR>
  122.  
  123. 3. The data stack space is the same as the dictionary space.
  124.  
  125. 4.  The return stack space was arbitrarily set at 256 bytes.   It 
  126. can be altered by remeta-compiling the system.
  127.  
  128. 5.  No  mass  storage block ranges are reserved  by  the  system, 
  129. other than the contents of the files that are distributed.
  130.  
  131. 6. The user has available to him blocks 0 thru 65534.  Note  that 
  132. block  0  may  not be used for loading.  Block  number  65535  is 
  133. reserved to indicate the buffer is missing.
  134.  
  135. 7. Any ascii terminal should work with this system.  If the  user 
  136. has  a  cursor  addressable terminal, the editor  can  be  easily 
  137. modified to take advantage of the terminal's characteristics.
  138.  
  139. 8. System action taken upon error conditions:
  140.  
  141.      ' <name> ['] <name>  not found results in ? error message
  142.      
  143.      */ */MOD / /MOD MOD UM/MOD  all division by 0 errors  result      
  144.      in a 0 quotient
  145.  
  146.      : in the case of an error, a ? error message will be printed
  147.  
  148.      DO if a nesting error occurs, the system will crash. (if you 
  149.      are lucky)
  150.